"""
API模块 - 主API入口
此模块是系统API的主入口点，负责注册各个版本的API蓝图
当前采用模块化结构，主要实现位于v1子模块
访问根路径: /api/
"""
from flask import Blueprint
from flask_restx import Api

# 创建API蓝图 - 此蓝图会被应用工厂注册到Flask应用
api_bp = Blueprint('api', __name__, url_prefix='/api')

# 创建主API文档
api = Api(
    api_bp,
    title='Flask API 接口文档',
    version='1.0',
    description='基于Flask的用户管理系统API文档',
    doc='/docs/'  # 文档首页路径
)

# 导入并注册v1模块
from .v1 import v1_bp, api as v1_api

# 将v1的命名空间添加到主API
for ns in v1_api.namespaces:
    if ns not in api.namespaces:
        api.add_namespace(ns)

# 蓝图注册已通过命名空间整合完成，不再需要单独注册v1_bp
# 所有API功能已通过命名空间整合到主API文档中
